home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Misc / LK_V1.06.LHA / LK V1.06 / HELP / overlayobject.hlp < prev    next >
Encoding:
INI File  |  1994-11-01  |  2.1 KB  |  54 lines
  1. [LANGUAGE english; PARENT keywords; PAGE 11-81]
  2. [C;6;B]        OVERLAYOBJECT or OO or OVRLMRG <filename>
  3. [7]Default: OBJECT
  4. [J;1;N]
  5.   Only the commercial version will have this instruction fully \
  6. supported. Registred people will receive that version.
  7.  
  8.   lk overlay handler program is given with this product \
  9. to enable programmers to make mofications and eventually \
  10. transform it completly. If you create an external handler, \
  11. you will have to specify it with the OVERLAYOBJECT \
  12. instruction.
  13.   You may put that object file into one of your libraries. In \
  14. this case you must give a specific name to the hunk section \
  15. of CODE which will be the program startup:
  16. [C;2]        OVERLAYENTRY or NTRYHUNK or ENTRYHUNK
  17. [1;J]
  18.   lk also offer another possibility. You can save your object \
  19. file as 'LK:LIB/overlay.o'. lk will automatically try to load \
  20. that file and it will use it rather than the internal one. That \
  21. file will never be used when the OVERLAYOBJECT instruction was \
  22. used.
  23.   The usage of OVERLAYOBJECT instruction will enable the \
  24. effect of memory instructions to be effective. The following \
  25. command line will link the overlay handler to be loaded in \
  26. fast memory:
  27. [2]      FAST OVERLAYOBJECT <filename>
  28. [1]
  29.   That object has to contain:
  30. [INDENT 6]    . a JSR/JMP to the '_ovl_root' which is the \
  31. startup point of the main program.
  32.     . a function called '_ovl_call' to ensure that the object \
  33. in overlays can be called (It was the function named '_ovlyMrg' \
  34. when you used Blink and Slink.)
  35.     . a starting overlay table with the magic long word \
  36. $0000ABCD followed by four null long words.
  37.     . a hunk of type CODE at start (It may contain some other \
  38. code or data and bss hunks.)
  39. [INDENT 2]
  40.   Note:
  41.     If you define a label or a function named '_ovl_root', \
  42. lk will use it as the startup program instead of the STARTUP \
  43. label or the first hunk of code.
  44. [INDENT]
  45.   See also:
  46. [L;3][LINK autooverlay]            AUTOOVERLAY
  47. [LINK filename]                <filename>
  48. [LINK nodataoverlaid]            NODATAOVERLAID
  49. [LINK nospecialdebug]            NOOVLDEBUG
  50. [LINK overlay]                OVERLAY
  51. [LINK shortreloc]            SHORTRELOCOVERLAY
  52. [LINK ovl]                The Overlays
  53. [5; LINK about; GOTO address]        Become Registred
  54.